unbounded
Function.prototype.bind replacement that provides an unbounded
hidden property on the returned bounded function, that contains the original unbounded function
Usage
This package functions like Function.prototype.bind
, however it exposes a hidden unbounded
property on the returned bounded function that contains the original unbounded function.
This is very useful as it means you can do (fn.unbounded || fn).length
to always get the correct amount of arguments, or (fn.unbounded || fn).toString()
to always get the source code of any function instead of getting function () { [native code] }
for bounded functions.
You can use unbounded via require('unbounded').binder
like so:
const { binder } = require('unbounded')
const context = { hello: 'world' }
function a() {
return this.hello
}
const b = binder.call(a, context)
equal(b(), context.hello, 'context was correct')
equal(b.unbounded, a, 'unbounded was correct')
Or you can patch Function.prototype.bind
directly:
require('unbounded').patch()
const context = { hello: 'world' }
function a() {
return this.hello
}
const b = a.bind(context)
equal(b(), context.hello, 'context was correct')
equal(b.unbounded, a, 'unbounded was correct')
Install
- Install:
npm install --save unbounded
- Import:
import * as pkg from ('unbounded')
- Require:
const pkg = require('unbounded')
<script type="module">
import * as pkg from '//dev.jspm.io/unbounded@5.4.0'
</script>
This package is published with the following editions:
unbounded
aliases unbounded/index.cjs
which uses the Editions Autoloader to automatically select the correct edition for the consumer's environmentunbounded/source/index.js
is ESNext source code for Node.js 6 || 8 || 10 || 12 || 14 || 16 || 18 || 20 || 21 with Require for modulesunbounded/edition-browsers/index.js
is ESNext compiled for web browsers with Require for modulesunbounded/edition-node-4/index.js
is ESNext compiled for Node.js 4 with Require for modules
History
Discover the release history by heading on over to the HISTORY.md
file.
Contribute
Discover how you can contribute by heading on over to the CONTRIBUTING.md
file.
Backers
Maintainers
These amazing people are maintaining this project:
No sponsors yet! Will you be the first?
Contributors
These amazing people have contributed code to this project:
Discover how you can contribute by heading on over to the CONTRIBUTING.md
file.
License
Unless stated otherwise all works are:
and licensed under: